home *** CD-ROM | disk | FTP | other *** search
/ Business Shareware / Business Shareware.iso / start / disk / megcpy10 / megacopy.doc < prev   
Text File  |  1993-04-26  |  13KB  |  280 lines
  1.  
  2. ███╗   ███╗ ███████╗  ██████╗   █████╗   ██████╗  ██████╗  ██████╗  ██╗   ██╗
  3. ████╗ ████║ ██╔════╝ ██╔════╝  ██╔══██╗ ██╔════╝ ██╔═══██╗ ██╔══██╗ ╚██╗ ██╔╝
  4. ██╔████╔██║ █████╗   ██║  ███╗ ███████║ ██║      ██║   ██║ ██████╔╝  ╚████╔╝
  5. ██║╚██╔╝██║ ██╔══╝   ██║   ██║ ██╔══██║ ██║      ██║   ██║ ██╔═══╝    ╚██╔╝
  6. ██║ ╚═╝ ██║ ███████╗ ╚██████╔╝ ██║  ██║ ╚██████╗ ╚██████╔╝ ██║         ██║
  7. ╚═╝     ╚═╝ ╚══════╝  ╚═════╝  ╚═╝  ╚═╝  ╚═════╝  ╚═════╝  ╚═╝         ╚═╝
  8.  
  9.                                 Version 1.0
  10.  
  11.                     A Multi-tasking "Copy" File Utility
  12.                     ───────────────────────────────────
  13.  
  14.                             Released  4/27/93
  15.  
  16.                             Copyright(c), 1993
  17.                                -=RyanWare=-
  18.                             Melbourne, Florida
  19.  
  20.                             FidoNet: 1:374/400
  21.                             SL_Net:  250:307/958
  22.  
  23. ┌────────────────────────────────────────────────────────────────────────┐
  24. │░░░░ What is  Mega-Copy ? ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  25. └────────────────────────────────────────────────────────────────────────┘
  26.         Mega-Copy was designed to be used as a "Local" file transfer
  27.         protocol for multi-node Searchlight BBS systems, but works
  28.         fine from the DOS command-line, and should work fine for any
  29.         BBS that can use external protocols such as DSZ.
  30.  
  31.  
  32. ┌────────────────────────────────────────────────────────────────────────┐
  33. │░░░░ Why Mega-Copy ? ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  34. └────────────────────────────────────────────────────────────────────────┘
  35.         Mega-Copy was written to be used on our BBS as an alternative to
  36.         the DOS copy command for 2 reasons:
  37.  
  38.         1)  DOS' copy command would slow the BBS down to a crawl anytime
  39.             we tried to copy files to a floppy drive.
  40.  
  41.         2)  Most of the files we copied to floppies where from our files
  42.             section, either for users that stopped by, or for us to use/
  43.             test on another system.  Though I have searched, I was unable
  44.             to find a replacement copy command that would accept the
  45.             @<filename> directive - as used by batch file transfer protocols,
  46.             such a Zmodem.  Thus requiring opening a DOS window any time
  47.             we wanted to copy multiple files to a floppy from the BBS -
  48.             A lot more difficult than tagging files <G>.
  49.  
  50.  
  51. ┌────────────────────────────────────────────────────────────────────────┐
  52. │░░░░ What can Mega-Copy do, that DOS' copy can't ? ░░░░░░░░░░░░░░░░░░░░░│
  53. └────────────────────────────────────────────────────────────────────────┘
  54.     ■  Graphical  user interface.
  55.  
  56.     ■  Multi-Tasking:
  57.  
  58.           Mega-Copy will attempt to detect any of the following
  59.           multi-tasking operating environments:
  60.  
  61.               DesqView
  62.               Windows
  63.               OS/2 (DOS Box)
  64.               DoubleDOS
  65.  
  66.           If such an environment is found,  Mega-Copy will use a small
  67.           4k buffer, for uploading/downloading (copying) files, in the
  68.           following manner:
  69.  
  70.               1) Read 4k of the source file into the buffer.
  71.               2) Write the 4k buffer to the destination file.
  72.               3) Pass 6 time-slices to the OS environment.
  73.               4) Repeat until the file is copied.
  74.               5) Repeat until all queued files copied.
  75.  
  76.           If you are running under DOS, with no multi-tasking environment,
  77.           Mega-Copy will use a larger 64k buffer, and skip the above time-
  78.           slice routines - copying at about the same speed as DOS' copy
  79.           command.
  80.  
  81.     ■  Local Protocol:
  82.  
  83.          Mega-Copy can be used as an external protocol on any BBS system
  84.          that allows such.  If used on a "Local Only" node, it will be
  85.          invisible to remote callers.  Any BBS that uses DSZ or a like
  86.          protocol engine for batch uploading and downloading should create
  87.          a temporary "batch queue" file - a file that lists each file to be
  88.          transferred, one file per line.
  89.  
  90.          Mega-Copy will accept this "batch queue" as a command-line argument.
  91.  
  92.     ■  Multi-Disk file copies:
  93.  
  94.          If you queue more files than will fit on your destination drive,
  95.          Mega-Copy will prompt you to replace your disk prior to starting
  96.          the copy procedure on the file that would exceed the disk's capacity.
  97.  
  98.     ■  Wildcards:
  99.  
  100.          Mega-Copy will accept the "*" and "?" wildcards as part of the
  101.          file spec of any/all files being copied.  The wildcards may be
  102.          in the "queue list" or on the command-line.
  103.  
  104.  
  105. ┌────────────────────────────────────────────────────────────────────────┐
  106. │░░░░ Examples: ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  107. └────────────────────────────────────────────────────────────────────────┘
  108.        Command Syntax:
  109.  
  110.        MC [@]<Filename.ext> [d:][path]
  111.  
  112.            ex.    mc @tempfile.txt a:\
  113.  
  114.              Would copy all files listed in "TEMPFILE.TXT" to the root
  115.              of drive a:
  116.  
  117.            ex.    mc a:\*.*
  118.                    -or-
  119.                   mc a:\.
  120.  
  121.              Would copy all files from A: drives root directory to the
  122.              current directory.
  123.  
  124. ┌────────────────────────────────────────────────────────────────────────┐
  125. │░░░░ Searchlight Sysops : ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  126. └────────────────────────────────────────────────────────────────────────┘
  127.  
  128.       To run Mega-Copy as a "Local" protocol on your Searchlight
  129.       multi-node BBS, run CONFIG.EXE from your local node's home
  130.       directory, select "A. General Configuration", then select
  131.       "E. Xfer Protocols Setup".
  132.  
  133.       Either select an empty spot, or replace a current protocol
  134.       with the following:
  135.  
  136. Searchlight BBS External Protocols Setup Menu
  137. 1. Protocol Name ................. Mega-Copy A:
  138. 2. Protocol Type ................. External
  139. 3. External Send Command ......... c:\utils\mc.exe @d:\NODEx\tempfile
  140. 4. External Receive Command ...... c:\utils\mc.exe a:%F
  141.  
  142.       Line 1:  This is optional <use any name that you wish>.
  143.       Line 2:  This MUST be set to EXTERNAL.
  144.       Line 3:  This is a two part "Send" (or download) command-line.
  145.                The first part must contain the path from where MEGACOPY
  146.                is located, eg...
  147.                                C:\UTILS\MC.EXE
  148.                The second part must start with the "@" character, then
  149.                a full legal DOS path\filename to a unique file from any
  150.                other node.  Searchlight will create this @filename, in
  151.                which will contain a list of all queued files for download.
  152.                            ex: @F:\NODEx\tempfile
  153.                where [F:\NODEx\] is the path to your local node's CONFIG.SL2
  154.  
  155.       Line 4:  This is a two part "Receive" (or upload) command-line.
  156.                The first part must contain the path from where MEGACOPY
  157.                is located, eg..
  158.                                C:\UTILS\MC.EXE
  159.                The second part must contain the path for the files
  160.                you wish to upload to your BBS (usually a floppy drive),
  161.                and the meta-string character that passes the uploaded
  162.                file name to the BBS.
  163.                eg...
  164.                               A:%F
  165. ┌────────────────────────────────────────────────────────────────────────┐
  166. │░░░░ W A R N I N G ! !   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  167. └────────────────────────────────────────────────────────────────────────┘
  168.  
  169.       If you can NOT secure Mega-Copy from remote users, either by
  170.       security levels, or private "local node" configurations,
  171.       DO NOT USE MEGA-COPY as a protocol on your BBS!
  172.  
  173. ┌────────────────────────────────────────────────────────────────────────┐
  174. │░░░░ User Interface : ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  175. └────────────────────────────────────────────────────────────────────────┘
  176.  
  177.       ■  Aborting:
  178.            You may, at any time, abort any file-copies in progress by
  179.            simply hitting your <Esc> key.
  180.  
  181.       ■  Disk full:
  182.            During file transfers there are several potential user error
  183.            menus that may pop up.  The most common of which, will appear
  184.            when your target drive has insufficient space for the next file.
  185.            In such cases, you will be prompted with the following choices:
  186.  
  187.                 <R>eplace removable media on drive [d:]
  188.                 <S>kip to next file.
  189.                 <A>bort.
  190.  
  191.            Choosing <R>eplace will give you the option to replace a floppy
  192.            diskette.
  193.            Choosing <S>kip will dump the current file from the copy queue.
  194.            Choosing <A>bort will abort the program.
  195.  
  196.       ■  Other errors:
  197.            Most other potential errors have been trapped, and will respond
  198.            either by halting the program with a brief note and error number,
  199.            or prompt you with the following menu:
  200.  
  201.                 <A>bort
  202.                 <R>etry
  203.  
  204.            If you encounter an error that was not coded into the error
  205.            trapping routines, Mega-Copy should respond with the following
  206.            message:
  207.  
  208.                 Unknown: xxx
  209.  
  210.           where "xxx" is an error number.  Please report any untrapped
  211.           errors to -=RyanWare=- so that they may be corrected in a later
  212.           version.
  213.  
  214. ┌────────────────────────────────────────────────────────────────────────┐
  215. │░░░░ Usual  Legal Stuff : ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  216. └────────────────────────────────────────────────────────────────────────┘
  217.       Mega-Copy has been provided "AS IS" without warranty of any kind.
  218.       -=RyanWare=-, or agents of -=RyanWare=-, will not be held liable
  219.       for lost or damaged software or hardware, or costs incurred by such
  220.       loss.
  221.  
  222.       This program may be freely used for no charge, in non-commercial
  223.       environments.  Commercial users please contact -=RyanWare=- for
  224.       extended use of this product. Comments are always welcome.
  225.  
  226.       You may freely distribute Mega-Copy, provided it is distributed
  227.       in it's original form:  no files are missing or altered on the
  228.       distribution disk, or in the distribution archive.  Commercial
  229.       shareware distributors may distribute this package, provided their
  230.       distribution fees are deemed reasonable by -=RyanWare=-, and their
  231.       intent of distribution is on file with -=RyanWare=-.
  232.  
  233. ┌────────────────────────────────────────────────────────────────────────┐
  234. │░░░░ Trademarks : ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  235. └────────────────────────────────────────────────────────────────────────┘
  236.       Searchlight BBS is a trademark of Searchlight Software.
  237.  
  238.         If you are interested in the finest BBS software available,
  239.         please contact Frank LaRosa at (516) 751-2966
  240.         or call Searchlight BBS at     (516) 689-2566
  241.  
  242.       DSZ is a trademark of Omen Technology.
  243.  
  244. ┌────────────────────────────────────────────────────────────────────────┐
  245. │░░░░ -=RyanWare=- ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  246. └────────────────────────────────────────────────────────────────────────┘
  247.            Mega-Copy and this document are copyright(c), 1993 by
  248.  
  249.                              -=RyanWare=-
  250.                            Melbourne, Florida
  251.  
  252.            The author of Mega-Copy may be contacted at:
  253.  
  254.                    @FidonetUSA :   1:374/400
  255.                    @SL_NetUSA  :   250:307/0
  256.                    Flamingo BBS:   (407) 253-0782 (USR DS 16.8)
  257.                    Voice       :   (407) 255-7713
  258.                    Snail Mail  :   Ron Ryan
  259.                                    1061 Ellen Ct.
  260.                                    Melbourne, Fl. 32935
  261.  
  262. ┌────────────────────────────────────────────────────────────────────────┐
  263. │░░░░  -=RyanWare=- Products : ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
  264. └────────────────────────────────────────────────────────────────────────┘
  265.  
  266.     ■   ANShell ...............  ANSI viewing shell.
  267.     ■   ANSI to SL ............  Converts ANSI to SL color codes.
  268.     ■   ArcDoctor .............  Last word in upload file processing.
  269.     ■   Best of Taglines '92 ..  One-liner interface for BBS systems and DOS.
  270.     ■   CVTMSG ................  Search and replace for Fido *.MSG files.
  271.     ■   Last Accessed .........  Subboard management tools for Searchlight.
  272.     ■   Mega-Copy .............  Graphical, multi-tasking copy protocol.
  273.     ■   RamPack ...............  Increase the speed of SL Pack by 1,200%!
  274.     ■   Scrab2SL ..............  Imports MSG.xxx files into SL mailboxes.
  275.     ■   SL2OOII ...............  Creates a drop file for Operation  Overkill.
  276.     ■   SL2SR  ................  Creates a DOORFILE.SR from Searchlight.
  277.     ■   StatsBar ..............  Users files info in Stats bar for use w/GSZ.
  278.     ■   Sublist ...............  Enhanced "List" command for Searchlight BBS'
  279.  
  280.